.. _ceaiCurrent_Get:

ceaiCurrent_Get
===============
---------------


SYNOPSIS
--------


.. code-block:: none

  VT_I4 ceaiCurrent_Get(
    VT_I4 Channel,
    VT_PR8 fCurrent
  )



DESCRIPTION
-----------


- 대상 아날로그 입력 채널에 대하여 A/D 변환을 수행하고, 그 값을 전류(Current) 값으로 반환합니다.



PARAMETER
---------


- Channel : 채널 번호. 통합 채널로 관리되는 채널 번호를 의미하며, 상수 값으로 0 (Zero Based). 이상, (최대 통합 채널수 - 1) 이하의 값을 채널 번호로 설정할 수 있습니다. 

- fCurrent : A/D 결과값을 전류(Current) 값으로 반환합니다. 단, 전압 범위 설정 모드를 3 번. (0~20mA) 또는 6 번 (4~20mA) 로 설정해야 합니다. 




RETURN VALUE
------------


+----------------+-------------------------------------------------------+
| Value          | Meaning                                               |
+================+=======================================================+
| 음수           | 수행 실패. 자세한 내용은 '에러 처리' 편을 참고합니다. |
+----------------+-------------------------------------------------------+
| 0 (ceERR_NONE) | 수행 성공                                             |
+----------------+-------------------------------------------------------+





Example
-------
.. code-block:: cpp
 :linenos:
 C/C++
 #include “ceSDK.h”
 #include “ceSDKDef.h”
 long nAiChNo = 1; // 아날로그 입력 채널
 double fCurrentVal; // A/D 결과를 전류 값으로 반환
 // A/D 결과값을 전류 값으로 반환합니다.
 if ( ceaiCurrent_Get ( nAiChNo, &fCurrentVal ) == ceERR_NONE ) 
 { 
  if ( fnCurrentVal == -1 ) // 전압 범위 입력 모드가 전류 모드가 아닙니다.
   {   
    // 전압 입력 모드를 3 번 (0~10V, 0 ~ 20mA) 로 설정합니다.
     ceaiVoltRangeMode_Set ( nAiChNo, 3 ); 
    }
 }